home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glxcreatecontext.z / glxcreatecontext
Encoding:
Text File  |  2002-10-03  |  6.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX        ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt - create a new GLX rendering context
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      GLXContext ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt( Display *_d_p_y,
  14.                                   XVisualInfo *_v_i_s,
  15.                                   GLXContext _s_h_a_r_e_L_i_s_t,
  16.                                   Bool _d_i_r_e_c_t )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _d_p_y        Specifies the connection to the X server.
  21.  
  22.      _v_i_s        Specifies the visual that defines the frame buffer resources
  23.                 available to the rendering context.  It is a pointer to an
  24.                 XXXXVVVViiiissssuuuuaaaallllIIIInnnnffffoooo structure, not a visual ID or a pointer to a
  25.                 VVVViiiissssuuuuaaaallll.
  26.  
  27.      _s_h_a_r_e_L_i_s_t  Specifies the context with which to share display lists.  NNNNUUUULLLLLLLL
  28.                 indicates that no sharing is to take place.
  29.  
  30.      _d_i_r_e_c_t     Specifies whether rendering is to be done with a direct
  31.                 connection to the graphics system if possible (TTTTrrrruuuueeee) or
  32.                 through the X server (FFFFaaaallllsssseeee).
  33.  
  34. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  35.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt creates a GLX rendering context and returns its handle.
  36.      This context can be used to render into both windows and GLX pixmaps.  If
  37.      ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt fails to create a rendering context, NNNNUUUULLLLLLLL is returned.
  38.  
  39.      If _d_i_r_e_c_t is TTTTrrrruuuueeee, then a direct rendering context is created if the
  40.      implementation supports direct rendering, if the connection is to an X
  41.      server that is local, and if a direct rendering context is available. (An
  42.      implementation may return an indirect context when _d_i_r_e_c_t is TTTTrrrruuuueeee).  If
  43.      _d_i_r_e_c_t is FFFFaaaallllsssseeee, then a rendering context that renders through the X
  44.      server is always created.  Direct rendering provides a performance
  45.      advantage in some implementations.  However, direct rendering contexts
  46.      cannot be shared outside a single process, and they may be unable to
  47.      render to GLX pixmaps.
  48.  
  49.      If _s_h_a_r_e_L_i_s_t is not NNNNUUUULLLLLLLL, then all display-list indexes and definitions
  50.      are shared by context _s_h_a_r_e_L_i_s_t and by the newly created context.  An
  51.      arbitrary number of contexts can share a single display-list space.
  52.      However, all rendering contexts that share a single display-list space
  53.      must themselves exist in the same address space.  Two rendering contexts
  54.      share an address space if both are nondirect using the same server, or if
  55.      both are direct and owned by a single process.  Note that in the
  56.      nondirect case, it is not necessary for the calling threads to share an
  57.      address space, only for their related rendering contexts to share an
  58.      address space.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))        OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX        ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      If the GL version is 1.1 or greater, then all texture objects except
  75.      object 0, are shared by any contexts that share display lists.
  76.  
  77. NNNNOOOOTTTTEEEESSSS
  78.      XXXXVVVViiiissssuuuuaaaallllIIIInnnnffffoooo is defined in _X_u_t_i_l._h.  It is a structure that includes
  79.      _v_i_s_u_a_l, _v_i_s_u_a_l_I_D, _s_c_r_e_e_n, and _d_e_p_t_h elements.
  80.  
  81.      A _p_r_o_c_e_s_s is a single execution environment, implemented in a single
  82.      address space, consisting of one or more threads.
  83.  
  84.      A _t_h_r_e_a_d is one of a set of subprocesses that share a single address
  85.      space, but maintain separate program counters, stack spaces, and other
  86.      related global data.  A _t_h_r_e_a_d that is the only member of its subprocess
  87.      group is equivalent to a _p_r_o_c_e_s_s.
  88.  
  89.      It may not be possible to render to a GLX pixmap with a direct rendering
  90.      context.
  91.  
  92. EEEERRRRRRRROOOORRRRSSSS
  93.      NNNNUUUULLLLLLLL is returned if execution fails on the client side.
  94.  
  95.      BBBBaaaaddddMMMMaaaattttcccchhhh is generated if the context to be created would not share the
  96.      address space or the screen of the context specified by _s_h_a_r_e_L_i_s_t.
  97.  
  98.      BBBBaaaaddddVVVVaaaalllluuuueeee is generated if _v_i_s is not a valid visual (for example, if a
  99.      particular GLX implementation does not support it).
  100.  
  101.      GGGGLLLLXXXXBBBBaaaaddddCCCCoooonnnntttteeeexxxxtttt is generated if _s_h_a_r_e_L_i_s_t is not a GLX context and is not
  102.      NNNNUUUULLLLLLLL.
  103.  
  104.      BBBBaaaaddddAAAAlllllllloooocccc is generated if the server does not have enough resources to
  105.      allocate the new context.
  106.  
  107.  
  108.  
  109. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  110.      ggggllllXXXXDDDDeeeessssttttrrrrooooyyyyCCCCoooonnnntttteeeexxxxtttt, ggggllllXXXXGGGGeeeettttCCCCoooonnnnffffiiiigggg, ggggllllXXXXIIIIssssDDDDiiiirrrreeeecccctttt, ggggllllXXXXMMMMaaaakkkkeeeeCCCCuuuurrrrrrrreeeennnntttt
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.